home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 4 / BBS in a Box - Macintosh - Volume IV (January 1992) (BBS in a Box).iso / Files / Tele / H / Host Server Doc Delphi < prev    next >
Encoding:
Text File  |  1987-07-19  |  5.3 KB  |  118 lines  |  [TEXT/MACA]
  1. This is version 3.4 of UW, a multiple-window interface to UNIX for
  2. the Macintosh computer.  The distribution for UW consists of two
  3. binary files for the Macintosh (in BinHex 4.0 format) and a number
  4. of source files for the (BSD) UNIX server.
  5.  
  6. The distribution includes the following directories:
  7.  
  8.     h    - all UW include files
  9.     server    - source code for the UW server
  10.     lib    - source code for the UW programmer's library
  11.     utility    - source code for miscellaneous utility programs
  12.     doc    - [nt]roff documentation (-ms and -man formats)
  13.     misc    - other things of possible interest
  14.  
  15. UW was developed alternately on a Sun 3 and 4.3BSD VAX.  It also
  16. has been tested (more briefly) on a Sun 2 (release 2.0), Integrated
  17. Solutions VME 68020 (release 3.05), and a Pyramid. It depends quite a
  18. bit upon BSD-specific features such as interprocess communication and
  19. will not run without modification on a System V UNIX system.
  20.  
  21. Pyramid users: the good news is that I was able to compile and run UW
  22. on a Pyramid.  The bad news is that I ran into several problems.  First,
  23. Pyramid uses the structure tag (and typedef name) "fdset_t" for the
  24. type of a select() bitmask.  The standard 4.[23]BSD name for this
  25. is "fd_set".  To compile UW for a Pyramid, add "-Dfd_set=fdset_t" to
  26. the CFLAGS macro in each of the makefiles.  Second, the Pyramid C
  27. compiler converts a multiply of an unsigned long by 16 into an
  28. arithmetic shift left of 4.  Since the sign bit (apparently)
  29. doesn't participate in the shift, this gives the wrong result for
  30. numbers greater than 0x7ffffff.  (It should perform a logical shift
  31. for unsigned longs.)  I've reluctantly changed the code so that
  32. multiplies by 16 are explicitly expressed as left shifts (for which the
  33. C compiler correctly generates logical shifts).
  34.  
  35. There are some differences in configuration for 4.2BSD and 4.3BSD.
  36. The VERSION parameter in the top-level "Makefile" should be set to
  37. 4.2 or 4.3 as appropriate.  If your machine is a hybrid, you may need
  38. to consult the makefiles in the subdirectories.  Sun 3.0 should be
  39. considered 4.2.  (However, if you have Sun 3.2, you should remove the
  40. definition of SETOWN_BUG in "lib/Makefile_4.2".)
  41.  
  42. A "make install" in the top-level directory will compile and install
  43. all of the (UNIX) pieces of the UW distribution.  As distributed,
  44. this will create a link between the directory name "/usr/include/uw"
  45. and the "h" subdirectory and will create a "/usr/local/bin/libuw.a"
  46. library file.  These two steps allow application program to use
  47.     #include <uw/uwlib.h>
  48. and
  49.     cc -o xyzzy xyzzy.o -luw
  50. for greater convenience in creating programs that use the UW library.
  51.  
  52. If you do not have the "getopt" library routine, you will find the
  53. source in "misc/getopt.c"  This source code was publicly distributed by
  54. AT&T and is also available in the "mod.sources" archive.  You should
  55. compile it and install it in your machine's "/lib/libc.a"  (Note that
  56. since it uses "strchr", you should compile it on a BSD system with the
  57. command "cc -O -c getopt.c -Dstrchr=index".)  [Sorry, I can't find a
  58. manual page which I can (legally) include.]  If you can't change
  59. "libc.a", then you should add it to the makefiles in the "server"
  60. and "lib" directories.
  61.  
  62. This version differs from the previous release (v2.10) in several
  63. significant ways:
  64.  
  65.     1)    Nearly everything has been reimplemented.  The cursor-addressible
  66.     terminal emulations are faster.  (Unfortunately, the Tek 4010
  67.     emulation is slower.)
  68.  
  69.     2)    An optional extended protocol provides much greater Mac-host
  70.     interaction.  The host can now examine and alter a number
  71.     of window characteristics (such as the window emulation type,
  72.     whether or not it is visible, its title, etc.).
  73.  
  74.     3)    If the host supports window resizing via ioctl() (4.3BSD and
  75.     Sun do), then window size changes on the Mac can optionally
  76.     be propagated to the host.  As a result, programs such as
  77.     "more" and "vi" can be used in windows smaller (or larger)
  78.     than 24x80.
  79.  
  80.     4)    UW will not run on a 128K Mac at all.  It is far too large now.
  81.  
  82.     5)    There is an ANSI-compatible terminal emulation.  It works with
  83.     the "ansi" and "aa-24" termcap definitions, but it needs more
  84.     work.  It does not have some of the more bizarre capabilities
  85.     of the VT-100.  (The author still uses the ADM-31 emulation
  86.     almost exclusively.)
  87.  
  88.     6)    It is possible to exit UW without performing a "Shutdown",
  89.     use the Mac for something else, relaunch UW and perform a
  90.     "Startup".  The host will recreate the windows on the Mac
  91.     (although the previous contents of the windows will be lost).
  92.  
  93. UW wants to use a 7-point version of the Monaco font.  Previous UW
  94. distributions included such a font; however, although a lot of work
  95. went into its creation, the font was originally derived from a 12-point
  96. Apple Monaco font.  To avoid possibile license violations, the 7-point
  97. font is no longer distributed with UW.
  98.  
  99. UW is not public domain.  It is copyrighted.  However, permission to
  100. copy UW is given provided that the copies are not sold and that the
  101. copyright notices are retained.
  102.  
  103. Comments about UW can be sent to the author (me) at the following
  104. addresses:
  105.  
  106.     ARPANET/MILNET:    jdb@s1-c.arpa
  107.  
  108.     UUCP:        {seismo,lll-crg,decwrl,caip}!mordor!jdb
  109.  
  110.     U.S. Mail:    John Bruner
  111.             Lawrence Livermore National Laboratory
  112.             P.O. Box 5503, L-276
  113.             Livermore, CA  94550
  114.  
  115. I try to answer all mail, but sometimes am unable to do so for reasons
  116. beyond my control (e.g. incomplete or incorrect return addresses,
  117. finicky mailers).
  118.